home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / utils / headstrt.arc / HEADSTRT.DOC < prev    next >
Text File  |  1989-03-21  |  10KB  |  224 lines
  1.  
  2.                            Head Start 1.1
  3.  
  4.                By Charles F. Johnson and John Eidsvoog
  5.                   Copyright 1989 CodeHead Software
  6.  
  7.                  Documentation by Charles F. Johnson
  8.                   Released: Monday, March 20, 1989
  9.  
  10.  
  11.      Head Start 1.1 is a complete rewrite of the popular/infamous public
  12. domain program, STARTGEM.  Its purpose is to easily allow you to
  13. auto-boot any type of program from your AUTO folder, including GEM
  14. programs.  Head Start is much more flexible than STARTGEM; you can
  15. choose from among a list of up to 128 programs to auto-boot, using the
  16. mouse.  And it's also more sturdy than STARTGEM; Head Start will wait
  17. until all desk accessories are loaded and the desktop is fully
  18. initialized, before running the auto-boot program.  STARTGEM has an
  19. annoying habit of auto-starting programs while the desk accessories are
  20. still loading, which can lead to all sorts of interesting and colorful
  21. system crashes. 
  22.  
  23.      Head Start 1.1 also has special hooks built into it, that allow it
  24. to communicate with MultiDesk.  These hooks allow you to auto-run any
  25. shell program which replaces the desktop (such as Neodesk 2.0), and make
  26. MultiDesk wait to load its accessories until the shell program is
  27. running.  (NOTE:  you should only use this option if you don't plan on
  28. quitting the auto-run shell program to the built-in desktop.  Also note
  29. that under most normal circumstances it's not desirable to use the
  30. 'WAIT' option.)
  31.  
  32.  
  33. Copyright stuff.
  34. ----------------
  35.  
  36.      Head Start 1.1, MAKELIST.PRG, and this document are Copyright 1989
  37. CodeHead Software.  However, they may be freely distributed as long as
  38. this text file, the Head Start program file, and the MAKELIST program
  39. file are all included.  Neither this document file (HEADSTRT.DOC) or the
  40. program files (HEADST11.PRG and MAKELIST.PRG) may be altered in any way. 
  41. Copies of these files may not be sold, and this document may not be
  42. reprinted, without the express written permission of CodeHead Software. 
  43.  
  44.      We've tried to make Head Start as bug-free as possible. 
  45. Nevertheless, CodeHead Software cannot be responsible for any damages
  46. that may occur as a result of the use (or misuse) of Head Start or
  47. MAKELIST.PRG.
  48.  
  49.  
  50. Preparing to use Head Start.
  51. ----------------------------
  52.  
  53.      Head Start 1.1 is designed to run from the AUTO folder on your boot
  54. disk; therefore the first thing you should do is copy HEADST11.PRG to
  55. your AUTO folder.  If you don't already have an AUTO folder on your boot
  56. disk, you will need to create one.  Refer to your ST users' manual if
  57. you're unsure about how to do this. 
  58.  
  59.      Before re-booting your system to try out Head Start, you'll need to
  60. create the Head Start data file, which contains a list of all the
  61. programs you wish to choose from.  When Head Start runs, it looks in the
  62. main directory of your boot disk for a file called HEADSTRT.DAT.  This
  63. data file is an ordinary ASCII text file, and can be created with any
  64. text editor and most word processors, or with the included MAKELIST.PRG
  65. (see below).  It consists of the full pathnames of each program file,
  66. each on its own line.  The file can contain up to 128 pathnames, and it
  67. can also contain comments (lines that start with a semi-colon) and blank
  68. lines.  Here's an example HEADSTRT.DAT file:
  69.  
  70. ------------------------------------------------------------------------
  71.  
  72. ; Example Head Start data file
  73.  
  74. C:\FLASH.PRG
  75. A:\TIMESET.PRG
  76. XW C:\NEODESK2\NEOMASTR.PRG
  77. B:\1STWORD\1STWORD.PRG
  78.  
  79.  
  80. ------------------------------------------------------------------------
  81.  
  82.      There are two special options which can be enabled for each program
  83. in the list.  These options are set by starting the line containing the
  84. pathname with a special character, either 'X' or 'W' (or both) followed
  85. by a space.  In our example, we've set both options on the line
  86. containing the pathname C:\NEODESK2\NEOMASTR.PRG.
  87.  
  88.      The 'X' option tells Head Start to make this program the default
  89. autorun program.  When Head Start runs, the selection cursor will be
  90. placed on this filename, and it will automatically be selected for
  91. autorunning if the timeout (see below) expires.  Only one program can be
  92. marked in this manner; if more than one line in the data file contains
  93. the 'X' flag, the first one will be used.
  94.  
  95.      The 'W' option is intended to be used in conjunction with our
  96. commercial product, MultiDesk.  If the 'W' option is set, Head Start
  97. will detect the presence of MultiDesk (versions 1.7 or higher) and tell
  98. it to wait to load its accessories and steal its vectors until the
  99. autorun program is actually running.  This enables MultiDesk to work
  100. in a more reliable fashion with certain "shell" programs such as Neodesk
  101. 2.0.  If you do not have MultiDesk installed, the 'W' option has no
  102. effect.  (See below for information on upgrading to MultiDesk 1.8.)
  103.  
  104.      The easiest way to create the HEADSTRT.DAT file is with the
  105. included MAKELIST program, which lets you use the GEM file selector to
  106. create the list of pathnames, and saves the list to a file of your
  107. choice.  MAKELIST will also let you set the 'X' and 'W' options for each
  108. pathname.  When you run MAKELIST.PRG, it will display its instructions
  109. on-screen -- therefore we won't document the program here.
  110.  
  111.      If only one filename is listed in HEADSTRT.DAT, Head Start will not
  112. even pause for input -- it will simply autorun that file.  (This lets
  113. you use it the same way you used to use STARTGEM, if you wish.)
  114.  
  115.  
  116. Running Head Start.
  117. -------------------
  118.  
  119.      Once the data file is created, re-boot your computer with the disk
  120. which contains the AUTO folder with HEADST11.PRG in it, and the
  121. HEADSTRT.DAT file in the main directory.  If you've set everything up
  122. properly, when Head Start runs it will display a list of the filenames
  123. contained in the HEADSTRT.DAT file.  If this list doesn't appear, make
  124. sure the HEADSTRT.DAT file is in the main directory of your boot disk,
  125. and that it contains valid pathnames and follows the format described
  126. above. 
  127.  
  128.      The selection cursor (a transparent box) will be placed either on
  129. the first name in the list, or on the default autorun program (which is
  130. specified with the 'X' option - see above)).  You can move the cursor
  131. around through the list of files with either the arrow keys or the
  132. mouse.  When the box is resting on the file you wish to autorun, press
  133. the Return key or the left mouse button to select it, and Head Start
  134. will continue.  To exit Head Start without selecting any autorun
  135. program, press the Esc key or the right mouse button. 
  136.  
  137.      If you have specified a default autorun program in your
  138. HEADSTRT.DAT file (with the 'X' option) and you don't move the mouse or
  139. type any keys when Head Start runs, it will "timeout" after five seconds
  140. and exit, automatically selecting the default program.  If no default
  141. program is specified, the timeout feature is disabled.
  142.  
  143.      When you exit Head Start 1.1 with an autorun program selected, Head
  144. Start leaves part of itself in RAM.  This "resident" code then watches
  145. for the right combination of events to tell it to autorun the chosen
  146. program.  When you exit with nothing selected, Head Start 1.1 is
  147. completely wiped from memory.
  148.  
  149.  
  150. A few caveats.
  151. --------------
  152.  
  153.      Head Start works by using techniques which are highly specific to
  154. the two versions of TOS that are currently in release.  It relies on
  155. certain sequences of Line F calls which are completely undocumented by
  156. Atari.  It's not our normal practice at CodeHead Software to use
  157. undocumented techniques; but unfortunately, this is the only way to
  158. reliably autorun a GEM program with the current versions of TOS. 
  159.  
  160.      This means that Head Start will only work (at present) on the
  161. original version of TOS in ROM, or the later revision which appeared
  162. with the Mega STs.  As of this writing, TOS 1.4 has still not been
  163. released by Atari, and the current version of Head Start 1.1 will not
  164. work with beta versions of TOS 1.4.  This shouldn't really matter, since
  165. TOS 1.4 has its own method of autorunning programs.
  166.  
  167.  
  168. Head Start 1.